Java’da SLF4j ve Log4j Loglama Rehberi: Spring Boot Logging

Java’da Loglama Neden Kritik?

Java ile sağlam ve ölçeklenebilir uygulamalar geliştirirken etkili bir loglama altyapısı; hata ayıklama, uygulama izleme ve performans hedefleri için vazgeçilmezdir. Doğru kurgulanmış loglar; üretim ortamındaki sorunları hızlı tespit etmenizi, servis davranışını izlemenizi ve olayları geriye dönük analiz etmenizi sağlar.

SLF4J Nedir? Avantajları Nelerdir?

SLF4J (Simple Logging Facade for Java), Java projelerinde loglama motorlarını soyutlayan bir facade katmanıdır. Kodunuzda org.slf4j.Logger ile log yazarsınız; altta Logback, Log4j2 veya JUL gibi farklı motorlar kullanılabilir.

• Taşınabilirlik: Log motorunu değiştirdiğinizde uygulama kodunu yeniden yazmanız gerekmez.
• Basit API: info, warn, error gibi standart seviyeler.
• Performans: Parametrik loglama ile gereksiz string işlemleri azalır.

Log4j Nedir? Neden Tercih Edilir?

Apache Log4j, Java için yüksek performanslı ve esnek bir loglama kütüphanesidir. Çoklu çıktı (console, file vb.), pattern’ler, filtreler ve asenkron loglama gibi gelişmiş özellikler sunar.

SLF4J vs Log4j: Temel Farklar ve Doğru Seçim

Spring Boot Logging: SLF4J ve Log4j2 Entegrasyonu

Spring Boot varsayılan olarak Logback ile gelir ve çoğu proje için yeterlidir. Log4j2 kullanmak istiyorsanız bağımlılıkları değiştirip log4j2.xml dosyanızı eklemeniz gerekir.

application.properties ile Log Seviyesi Yönetimi

logging.level.root=INFO
logging.level.org.springframework=INFO
logging.level.org.hibernate=INFO

Spring Boot ile org.slf4j.Logger Kullanımı

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HomeController {
  private static final Logger log = LoggerFactory.getLogger(HomeController.class);

  @GetMapping("/")
  public String home() {
    log.info("HomeController -> home() çağrıldı");
    return "Merhaba, Spring Boot Logging!";
  }
}

Parametrik Loglama ile Performans

Parametrik loglama, log seviyesi aktif değilse gereksiz string birleştirmelerini engeller ve performansı korur:

String userId = "42";
log.info("Kullanıcı oturumu başlatıldı: id={}", userId);

log4j2.xml Örneği (Modern Konfigürasyon)

<Configuration status="WARN">
  <Appenders>
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="%d{HH:mm:ss} %-5p %c{1}:%L - %m%n"/>
    </Console>
    <File name="File" fileName="logs/app.log">
      <PatternLayout pattern="%d %-5p [%t] %c - %m%n"/>
    </File>
  </Appenders>
  <Loggers>
    <Root level="info">
      <AppenderRef ref="Console"/>
      <AppenderRef ref="File"/>
    </Root>
  </Loggers>
</Configuration>

Maven: SLF4J & Log4j2 Bağımlılıkları

<!-- SLF4j API -->
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-api</artifactId>
  <version>2.0.16</version>
</dependency>

<!-- Log4j2 Core + SLF4j Köprüsü -->
<dependency>
  <groupId>org.apache.logging.log4j</groupId>
  <artifactId>log4j-core</artifactId>
  <version>2.23.1</version>
</dependency>
<dependency>
  <groupId>org.apache.logging.log4j</groupId>
  <artifactId>log4j-slf4j2-impl</artifactId>
  <version>2.23.1</version>
</dependency>

Production Best Practices (2026)

• Log seviyelerini (INFO/WARN/ERROR) ortam bazlı yönetin (dev/prod).
• PII / hassas veri (token, şifre, kart vb.) loglamayın veya maskeleyin.
• Correlation ID (traceId) ile istek bazlı izleme yapın.
• Dosya loglarında rolling kullanın (boyut/gün bazlı döndürme).
• Yüksek trafikte async logging (Log4j2 Async) değerlendirin.

Sık Sorulan Sorular (SSS)

Sonuç

Java projelerinde en sağlıklı yaklaşım: kodda SLF4J, altyapıda ihtiyaca göre Logback veya Log4j2 kullanmaktır. Spring Boot ile seviyeleri application.properties üzerinden yönetebilir, Log4j2 için log4j2.xml ile güçlü bir yapı kurabilirsiniz.